Installing a Bugfix

Structure of a Cumulative Bugfix File

A cumulative bugfix is a zip file with a name formatted as
orc<version>_<date>_cumulative_bugfix_<version2>-build<buildnr>.zip.

For example, a bugfix file may be named
orc4614_20170707_cumulative_bugfix_4.6.1.4-build28.zip.

A cumulative bugfix file always includes:

• A file named <filename>.txt containing a description of the fix (e.g., orc4614_20170707_cumulative_bugfix_4.6.1.4-build28.txt).

• Subdirectories to be copied into the Orchestra directory orchestra/WEB-INF. Typically, a bugfix contains two subdirectories named classes and lib:

  • The classes subdirectory mirrors the full structure of the directory orchestra/WEB-INF/classes.
  • The lib subdirectory includes a set of modified jar files. Each modified jar file will have a new version number. If a jar file has a new version number, the bugfix will also include a dummy file with the old version number (which is an empty zip file). The user can simply copy the contents of the directory over the existing directory, replacing files as necessary.

Example:
If your lib directory currently contains orchestra-domain-4.6.1.0.jar and orchestra-domain-4.6.1.1.jar, with orchestra-domain-4.6.1.0.jar being an empty zip file, a subsequent cumulative bugfix might contain orchestra-domain-4.6.1.0.jar, orchestra-domain-4.6.1.1.jar, and orchestra-domain-4.6.1.2.jar, where orchestra-domain-4.6.1.0.jar and orchestra-domain-4.6.1.1.jar will be empty zip files.

Installation of a Bugfix

1. Unpack the zip file.

2. Copy the subdirectories contained in the unpacked bugfix directory to the directory <tomcat installation dir>/webapps/orchestra/WEB-INF. Ensure that existing files are replaced.